Revista do CD-ROM 101/CD-ROM 101.iso/compl/maya5ple/Install_MayaPLE5_English.exe/Maya/Data1.cab/performScaleConstraint.mel

Text File | 2003-07-17 | 12.4 KB | 499 lines

// Copyright (C) 1997-2002 Alias|Wavefront,
// a division of Silicon Graphics Limited.
//
// The information in this file is provided for the exclusive use of the
// licensees of Alias|Wavefront.  Such users have the right to use, modify,
// and incorporate this code into other products for purposes authorized
// by the Alias|Wavefront license agreement, without fee.
//
// ALIAS|WAVEFRONT DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
// INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
// EVENT SHALL ALIAS|WAVEFRONT BE LIABLE FOR ANY SPECIAL, INDIRECT OR
// CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
// DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
// TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
// PERFORMANCE OF THIS SOFTWARE.
//
//
//  Alias|Wavefront Script File
//  MODIFY THIS AT YOUR OWN RISK
//
//  Creation Date:  24 April 1997
//
//  Description:
//        This script provides an option box dialog for the scaleConstraint command.
//
//    Input Arguments:
//        boolean showOptionBox    true - show the option box dialog
//                                false - just execute the command
//

//
//  Procedure Name:
//      setOptionVars
//
//  Description:
//        Initialize the option values.
//
//  Input Arguments:
//        Whether to set the options to default values.
//
//  Return Value:
//      None.
//
proc setOptionVars(int $forceFactorySettings)
{
    //    weight
    //
    if ($forceFactorySettings || !`optionVar -exists scaleConstraintWeight`) {
        optionVar -floatValue scaleConstraintWeight 1.0;
    }

    // offset values
    //
    if ($forceFactorySettings ||
        !`optionVar -exists scaleConstOffsetX`) {
        optionVar -floatValue scaleConstOffsetX 1.0;
    }
    if ($forceFactorySettings ||
        !`optionVar -exists scaleConstOffsetY`) {
        optionVar -floatValue scaleConstOffsetY 1.0;
    }
    if ($forceFactorySettings ||
        !`optionVar -exists scaleConstOffsetZ`) {
        optionVar -floatValue scaleConstOffsetZ 1.0;
    }

    // maintain existing offset
    //
    if ($forceFactorySettings ||
        !`optionVar -exists scaleConstMaintainOffset`) {
        optionVar -intValue scaleConstMaintainOffset 0;
    }

    // Constraint axes
    //
    if ($forceFactorySettings ||
        !`optionVar -exists  scaleConstraintAxisX`) {
        optionVar -intValue scaleConstraintAxisX true;
    }
    if ($forceFactorySettings ||
        !`optionVar -exists  scaleConstraintAxisY`) {
        optionVar -intValue scaleConstraintAxisY true;
    }
    if ($forceFactorySettings ||
        !`optionVar -exists  scaleConstraintAxisZ`) {
        optionVar -intValue scaleConstraintAxisZ true;
    }

}

//
//  Procedure Name:
//      scaleConstraintSetup
//
//  Description:
//        Update the state of the option box UI to reflect the option values.
//
//  Input Arguments:
//      parent               - Top level parent layout of the option box UI.
//                             Required so that UI object names can be
//                             successfully resolved.
//
//        forceFactorySettings - Whether the option values should be set to
//                             default values.
//
//  Return Value:
//      None.
//
global proc scaleConstraintSetup(string $parent, int $forceFactorySettings)
{
    //    Retrieve the option settings
    //
    setOptionVars($forceFactorySettings);

    setParent $parent;

    //    Query the optionVar's and set the values into the controls.

    //    weight
    //
    floatSliderGrp -edit
        -value `optionVar -query scaleConstraintWeight`
        scaleConstraintWeight;

    float $sx = `optionVar -query scaleConstOffsetX`;
    float $sy = `optionVar -query scaleConstOffsetY`;
    float $sz = `optionVar -query scaleConstOffsetZ`;
    if (`optionVar -query scaleConstMaintainOffset`) {
        checkBoxGrp -edit -value1 1 scaleConstraintMaintainWidget;
        floatFieldGrp -edit -enable 0 offsetField;
    } else {
        checkBoxGrp -edit -value1 0 scaleConstraintMaintainWidget;
        floatFieldGrp -edit -enable 1 offsetField;
    }
    floatFieldGrp -e -v1 $sx -v2 $sy -v3 $sz offsetField;

    //  Axis values
    //
    int $axisX = `optionVar -query scaleConstraintAxisX`;
    int $axisY = `optionVar -query scaleConstraintAxisY`;
    int $axisZ = `optionVar -query scaleConstraintAxisZ`;
    // if all axes are on, select the all box and dim the individual axes
    if ($axisX && $axisY && $axisZ) {
        checkBoxGrp -edit -value1 true axesAll;
        checkBoxGrp -edit -value1 false -value2 false -value3 false axesXYZ;
    }
    // otherwise just select those boxes corresponding to 'on' axes
    else {
        checkBoxGrp -edit -value1 false axesAll;
        checkBoxGrp -edit -value1 $axisX -value2 $axisY -value3 $axisZ axesXYZ;
    }
}

//
//  Procedure Name:
//      scaleConstraintCallback
//
//  Description:
//        Update the option values with the current state of the option box UI.
//
//  Input Arguments:
//      parent - Top level parent layout of the option box UI.  Required so
//               that UI object names can be successfully resolved.
//
//        doIt   - Whether the command should execute.
//
//  Return Value:
//      None.
//
global proc scaleConstraintCallback(string $parent, int $doIt)
{
    setParent $parent;

    //    Set the optionVar's from the control values, and then
    //    perform the command.

    //    weight
    //
    optionVar -floatValue scaleConstraintWeight
        `floatSliderGrp -query -value scaleConstraintWeight`;

    // maintain offset
    //
    optionVar -intValue scaleConstMaintainOffset `checkBoxGrp  -query -value1 scaleConstraintMaintainWidget`;

    //    Offset values
    //
    optionVar -floatValue scaleConstOffsetX
        `floatFieldGrp -query -v1 offsetField`;
    optionVar -floatValue scaleConstOffsetY
        `floatFieldGrp -query -v2 offsetField`;
    optionVar -floatValue scaleConstOffsetZ
        `floatFieldGrp -query -v3 offsetField`;

    // Axis values
    //

    // Either the 'All' box is checked (and so all axes are on) ...
    if ( `checkBoxGrp -query -value1 axesAll` ) {
        optionVar -intValue scaleConstraintAxisX true;
        optionVar -intValue scaleConstraintAxisY true;
        optionVar -intValue scaleConstraintAxisZ true;
    } else {
        // ... Or only those axes specifically selected are on
        optionVar -intValue scaleConstraintAxisX
            `checkBoxGrp -query -value1 axesXYZ`;
        optionVar -intValue scaleConstraintAxisY
            `checkBoxGrp -query -value2 axesXYZ`;
        optionVar -intValue scaleConstraintAxisZ
            `checkBoxGrp -query -value3 axesXYZ`;
    }

    if ($doIt) {
        performScaleConstraint 0;
        addToRecentCommandQueue "performScaleConstraint 0" "ScaleConstraint";
    }
}


//
//  Procedure Name:
//      scaleConstraintOptions
//
//  Description:
//        Construct the option box UI.  Involves accessing the standard option
//        box and customizing the UI accordingly.
//
//  Input Arguments:
//      None.
//
//  Return Value:
//      None.
//
proc scaleConstraintOptions()
{
    //    Name of the command for this option box.
    //
    string $commandName = "scaleConstraint";

    //    Build the option box actions.
    //
    string $callback = ($commandName + "Callback");
    string $setup = ($commandName + "Setup");

    //    Get the option box.
    //
    string $layout = getOptionBox();
    setParent $layout;

    //    Pass the command name to the option box.
    //
    setOptionBoxCommandName($commandName);

    //    Activate the default UI template.
    //
    setUITemplate -pushTemplate DefaultTemplate;

    //    Turn on the wait cursor.
    //
    waitCursor -state 1;

    tabLayout -scr true -tv false;
    string $parent = `columnLayout -adjustableColumn 1`;

    checkBoxGrp
        -label "Maintain Offset"
        -label1 " "
        -annotation "Preserve the initial offset between the object and the target(s)"
        -numberOfCheckBoxes 1
        -cc ("floatFieldGrp -edit -enable (! #1) offsetField;")
        scaleConstraintMaintainWidget;

    floatFieldGrp -label "Offset"
        -numberOfFields 3
        offsetField;

    separator;

    //      Constraint Axes Selection Boxes
    //

    // The 'axesAll' checkBoxGrp and the 'axesXYZ' checkBoxGrp are linked
    // such that when 'axesAll' is selected, all the 'axesXYZ' boxes are
    // unselected. And when any 'axesXYZ' box is selected the 'axesAll'
    // box is deselected.
    checkBoxGrp -numberOfCheckBoxes 1 -label "Constraint Axes"
        -label1 "All"
        -onCommand ("checkBoxGrp -edit " +
                    "-value1 false " +
                    "-value2 false " +
                    "-value3 false " +
                    "axesXYZ")
        axesAll;

    checkBoxGrp -numberOfCheckBoxes 3
        -label1 "X"
        -label2 "Y"
        -label3 "Z"
        -onCommand ("checkBoxGrp -edit " +
                    "-value1 false " +
                    "axesAll;")
        axesXYZ;

    separator;

    floatSliderGrp -label "Weight"
        -field true -min 0.0 -max 10.0
        scaleConstraintWeight;


    //    Turn off the wait cursor.
    //
    waitCursor -state 0;

    //    Deactivate the default UI template.
    //
    setUITemplate -popTemplate;

    //    'Apply' button.
    //
    string $applyBtn = getOptionBoxApplyBtn();
    button -edit
        -label "Add"
        -command ($callback + " " + $parent + " " + 1)
        $applyBtn;

    //    'Save' button.
    //
    string $saveBtn = getOptionBoxSaveBtn();
    button -edit
        -command ($callback + " " + $parent + " " + 0 + "; hideOptionBox")
        $saveBtn;

    //    'Reset' button.
    //
    string $resetBtn = getOptionBoxResetBtn();
    button -edit
        -command ($setup + " " + $parent + " " + 1)
        $resetBtn;

    //    Set the option box title.
    //
    setOptionBoxTitle("Scale Constraint Options");

    //    Customize the 'Help' menu item text.
    //
    setOptionBoxHelpTag( "Scale" );

    //    Set the current values of the option box.
    //
    eval (($setup + " " + $parent + " " + 0));

    //    Show the option box.
    //
    showOptionBox();
}

//
//  Procedure Name:
//      scaleConstraintHelp
//
//  Description:
//        Return a short description about this command.
//
//  Input Arguments:
//      None.
//
//  Return Value:
//      string.
//
proc string scaleConstraintHelp()
{
    // ******** Example
    // "  Command: Extrude - create a surface using extrusion.\n" +
    // "Selection: curves and isoparms."

    return
    "  Command: scaleConstraint - constrain the scale to average of the targets\n" +
    "Selection: transforms.";
}

//
//  Procedure Name:
//      assembleCmd
//
//  Description:
//        Construct the command that will apply the option box values.
//
//  Input Arguments:
//      None.
//
//  Return Value:
//      None.
//
proc string assembleCmd()
{
    string $cmd = "scaleConstraint";

    setOptionVars(false);

    if (`optionVar -query scaleConstMaintainOffset`) {
        $cmd = ($cmd + " -mo");
    } else {
        //    Translate values
        //
        float $tx = `optionVar -query scaleConstOffsetX`;
        float $ty = `optionVar -query scaleConstOffsetY`;
        float $tz = `optionVar -query scaleConstOffsetZ`;
        $cmd = ($cmd + " -offset " + $tx + " " + $ty + " " + $tz );
    }

    // Axis values
    //

    // The axis values are inverted so that they represent
    // which axes to *skip* as opposed to which axes are on.
    int $axisX = !`optionVar -query scaleConstraintAxisX`;
    int $axisY = !`optionVar -query scaleConstraintAxisY`;
    int $axisZ = !`optionVar -query scaleConstraintAxisZ`;

    // If any of these values is true, that means that one
    // or more axes are to be skipped.
    if ($axisX)
        $cmd = ($cmd + " -skip x");
    if ($axisY)
        $cmd = ($cmd + " -skip y");
    if ($axisZ)
        $cmd = ($cmd + " -skip z");

    $cmd = ($cmd
            + " -weight " + `optionVar -query scaleConstraintWeight`);

    return $cmd;
}

//
//  Procedure Name:
//      performScaleConstraint
//
//  Description:
//        Perform the scaleConstraint command using the corresponding
//        option values.  This procedure will also show the option box
//        window if necessary as well as construct the command string
//        that will invoke the scaleConstraint command with the current
//        option box values.
//
//  Input Arguments:
//      0 - Execute the command.
//      1 - Show the option box dialog.
//      2 - Return the command.
//
//  Return Value:
//      None.
//
global proc string performScaleConstraint(int $action)
{
    string $cmd = "";

    switch ($action) {

        //    Execute the command.
        //
        case 0:
            //    Retrieve the option settings
            //
            setOptionVars(false);

            //    Get the command.
            //
            $cmd = `assembleCmd`;

            //    Execute the command with the option settings.
            //
            evalEcho($cmd);

            break;

        //    Show the option box.
        //
        case 1:
            scaleConstraintOptions;
            break;

        //    Return the command string.
        //
        case 2:
            //    Retrieve the option settings.
            //
            setOptionVars (false);

            //    Get the command.
            //
            $cmd = `assembleCmd`;
            break;
    }
    return $cmd;
}